home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_xemacs.idb / usr / freeware / lib / xemacs-20.4 / info / gnus.info-4.z / gnus.info-4
Encoding:
GNU Info File  |  1998-05-21  |  47.9 KB  |  1,341 lines
  1. This is Info file ../info/gnus.info, produced by Makeinfo version 1.68
  2. from the input file gnus.texi.
  3.  
  4.    This file documents Gnus, the GNU Emacs newsreader.
  5.  
  6.    Copyright (C) 1995,96 Free Software Foundation, Inc.
  7.  
  8.    Permission is granted to make and distribute verbatim copies of this
  9. manual provided the copyright notice and this permission notice are
  10. preserved on all copies.
  11.  
  12.    Permission is granted to copy and distribute modified versions of
  13. this manual under the conditions for verbatim copying, provided also
  14. that the entire resulting derived work is distributed under the terms
  15. of a permission notice identical to this one.
  16.  
  17.    Permission is granted to copy and distribute translations of this
  18. manual into another language, under the above conditions for modified
  19. versions.
  20.  
  21. 
  22. File: gnus.info,  Node: Shared Articles,  Next: PostScript Files,  Prev: Uuencoded Articles,  Up: Decoding Articles
  23.  
  24. Shared Articles
  25. ---------------
  26.  
  27. `X s'
  28.      Unshars the current series (`gnus-uu-decode-unshar').
  29.  
  30. `X S'
  31.      Unshars and saves the current series
  32.      (`gnus-uu-decode-unshar-and-save').
  33.  
  34. `X v s'
  35.      Unshars and views the current series
  36.      (`gnus-uu-decode-unshar-view').
  37.  
  38. `X v S'
  39.      Unshars, views and saves the current series
  40.      (`gnus-uu-decode-unshar-and-save-view').
  41.  
  42. 
  43. File: gnus.info,  Node: PostScript Files,  Next: Decoding Variables,  Prev: Shared Articles,  Up: Decoding Articles
  44.  
  45. PostScript Files
  46. ----------------
  47.  
  48. `X p'
  49.      Unpack the current PostScript series (`gnus-uu-decode-postscript').
  50.  
  51. `X P'
  52.      Unpack and save the current PostScript series
  53.      (`gnus-uu-decode-postscript-and-save').
  54.  
  55. `X v p'
  56.      View the current PostScript series
  57.      (`gnus-uu-decode-postscript-view').
  58.  
  59. `X v P'
  60.      View and save the current PostScript series
  61.      (`gnus-uu-decode-postscript-and-save-view').
  62.  
  63. 
  64. File: gnus.info,  Node: Decoding Variables,  Next: Viewing Files,  Prev: PostScript Files,  Up: Decoding Articles
  65.  
  66. Decoding Variables
  67. ------------------
  68.  
  69.    Adjective, not verb.
  70.  
  71. * Menu:
  72.  
  73. * Rule Variables::          Variables that say how a file is to be viewed.
  74. * Other Decode Variables::  Other decode variables.
  75. * Uuencoding and Posting::  Variables for customizing uuencoding.
  76.  
  77. 
  78. File: gnus.info,  Node: Rule Variables,  Next: Other Decode Variables,  Up: Decoding Variables
  79.  
  80. Rule Variables
  81. ..............
  82.  
  83.    Gnus uses "rule variables" to decide how to view a file.  All these
  84. variables are of the form
  85.  
  86.            (list '(regexp1 command2)
  87.                  '(regexp2 command2)
  88.                  ...)
  89.  
  90. `gnus-uu-user-view-rules'
  91.      This variable is consulted first when viewing files.  If you wish
  92.      to use, for instance, `sox' to convert an `.au' sound file, you
  93.      could say something like:
  94.           (setq gnus-uu-user-view-rules
  95.                 (list '(\"\\\\.au$\" \"sox %s -t .aiff > /dev/audio\")))
  96.  
  97. `gnus-uu-user-view-rules-end'
  98.      This variable is consulted if Gnus couldn't make any matches from
  99.      the user and default view rules.
  100.  
  101. `gnus-uu-user-archive-rules'
  102.      This variable can be used to say what commands should be used to
  103.      unpack archives.
  104.  
  105. 
  106. File: gnus.info,  Node: Other Decode Variables,  Next: Uuencoding and Posting,  Prev: Rule Variables,  Up: Decoding Variables
  107.  
  108. Other Decode Variables
  109. ......................
  110.  
  111. `gnus-uu-grabbed-file-functions'
  112.      All functions in this list will be called right after each file
  113.      has been successfully decoded--so that you can move or view files
  114.      right away, and don't have to wait for all files to be decoded
  115.      before you can do anything.  Ready-made functions you can put in
  116.      this list are:
  117.  
  118.     `gnus-uu-grab-view'
  119.           View the file.
  120.  
  121.     `gnus-uu-grab-move'
  122.           Move the file (if you're using a saving function.)
  123.  
  124. `gnus-uu-be-dangerous'
  125.      Specifies what to do if unusual situations arise during decoding.
  126.      If `nil', be as conservative as possible.  If `t', ignore things
  127.      that didn't work, and overwrite existing files.  Otherwise, ask
  128.      each time.
  129.  
  130. `gnus-uu-ignore-files-by-name'
  131.      Files with name matching this regular expression won't be viewed.
  132.  
  133. `gnus-uu-ignore-files-by-type'
  134.      Files with a MIME type matching this variable won't be viewed.
  135.      Note that Gnus tries to guess what type the file is based on the
  136.      name.  `gnus-uu' is not a MIME package (yet), so this is slightly
  137.      kludgey.
  138.  
  139. `gnus-uu-tmp-dir'
  140.      Where `gnus-uu' does its work.
  141.  
  142. `gnus-uu-do-not-unpack-archives'
  143.      Non-`nil' means that `gnus-uu' won't peek inside archives looking
  144.      for files to display.
  145.  
  146. `gnus-uu-view-and-save'
  147.      Non-`nil' means that the user will always be asked to save a file
  148.      after viewing it.
  149.  
  150. `gnus-uu-ignore-default-view-rules'
  151.      Non-`nil' means that `gnus-uu' will ignore the default viewing
  152.      rules.
  153.  
  154. `gnus-uu-ignore-default-archive-rules'
  155.      Non-`nil' means that `gnus-uu' will ignore the default archive
  156.      unpacking commands.
  157.  
  158. `gnus-uu-kill-carriage-return'
  159.      Non-`nil' means that `gnus-uu' will strip all carriage returns
  160.      from articles.
  161.  
  162. `gnus-uu-unmark-articles-not-decoded'
  163.      Non-`nil' means that `gnus-uu' will mark unsuccessfully decoded
  164.      articles as unread.
  165.  
  166. `gnus-uu-correct-stripped-uucode'
  167.      Non-`nil' means that `gnus-uu' will *try* to fix uuencoded files
  168.      that have had trailing spaces deleted.
  169.  
  170. `gnus-uu-view-with-metamail'
  171.      Non-`nil' means that `gnus-uu' will ignore the viewing commands
  172.      defined by the rule variables and just fudge a MIME content type
  173.      based on the file name.  The result will be fed to `metamail' for
  174.      viewing.
  175.  
  176. `gnus-uu-save-in-digest'
  177.      Non-`nil' means that `gnus-uu', when asked to save without
  178.      decoding, will save in digests.  If this variable is `nil',
  179.      `gnus-uu' will just save everything in a file without any
  180.      embellishments.  The digesting almost conforms to RFC1153--no easy
  181.      way to specify any meaningful volume and issue numbers were found,
  182.      so I simply dropped them.
  183.  
  184. 
  185. File: gnus.info,  Node: Uuencoding and Posting,  Prev: Other Decode Variables,  Up: Decoding Variables
  186.  
  187. Uuencoding and Posting
  188. ......................
  189.  
  190. `gnus-uu-post-include-before-composing'
  191.      Non-`nil' means that `gnus-uu' will ask for a file to encode
  192.      before you compose the article.  If this variable is `t', you can
  193.      either include an encoded file with `C-c C-i' or have one included
  194.      for you when you post the article.
  195.  
  196. `gnus-uu-post-length'
  197.      Maximum length of an article.  The encoded file will be split into
  198.      how many articles it takes to post the entire file.
  199.  
  200. `gnus-uu-post-threaded'
  201.      Non-`nil' means that `gnus-uu' will post the encoded file in a
  202.      thread.  This may not be smart, as no other decoder I have seen is
  203.      able to follow threads when collecting uuencoded articles.  (Well,
  204.      I have seen one package that does that--`gnus-uu', but somehow, I
  205.      don't think that counts...) Default is `nil'.
  206.  
  207. `gnus-uu-post-separate-description'
  208.      Non-`nil' means that the description will be posted in a separate
  209.      article.  The first article will typically be numbered (0/x).  If
  210.      this variable is `nil', the description the user enters will be
  211.      included at the beginning of the first article, which will be
  212.      numbered (1/x).  Default is `t'.
  213.  
  214. 
  215. File: gnus.info,  Node: Viewing Files,  Prev: Decoding Variables,  Up: Decoding Articles
  216.  
  217. Viewing Files
  218. -------------
  219.  
  220.    After decoding, if the file is some sort of archive, Gnus will
  221. attempt to unpack the archive and see if any of the files in the
  222. archive can be viewed.  For instance, if you have a gzipped tar file
  223. `pics.tar.gz' containing the files `pic1.jpg' and `pic2.gif', Gnus will
  224. uncompress and de-tar the main file, and then view the two pictures.
  225. This unpacking process is recursive, so if the archive contains archives
  226. of archives, it'll all be unpacked.
  227.  
  228.    Finally, Gnus will normally insert a "pseudo-article" for each
  229. extracted file into the summary buffer.  If you go to these "articles",
  230. you will be prompted for a command to run (usually Gnus will make a
  231. suggestion), and then the command will be run.
  232.  
  233.    If `gnus-view-pseudo-asynchronously' is `nil', Emacs will wait until
  234. the viewing is done before proceeding.
  235.  
  236.    If `gnus-view-pseudos' is `automatic', Gnus will not insert the
  237. pseudo-articles into the summary buffer, but view them immediately.  If
  238. this variable is `not-confirm', the user won't even be asked for a
  239. confirmation before viewing is done.
  240.  
  241.    If `gnus-view-pseudos-separately' is non-`nil', one pseudo-article
  242. will be created for each file to be viewed.  If `nil', all files that
  243. use the same viewing command will be given as a list of parameters to
  244. that command.
  245.  
  246.    If `gnus-insert-pseudo-articles' is non-`nil', insert
  247. pseudo-articles when decoding.  It is `t' by default.
  248.  
  249.    So; there you are, reading your *pseudo-articles* in your *virtual
  250. newsgroup* from the *virtual server*; and you think: Why isn't anything
  251. real anymore? How did we get here?
  252.  
  253. 
  254. File: gnus.info,  Node: Article Treatment,  Next: Article Commands,  Prev: Decoding Articles,  Up: The Summary Buffer
  255.  
  256. Article Treatment
  257. =================
  258.  
  259.    Reading through this huge manual, you may have quite forgotten that
  260. the object of newsreaders is to actually, like, read what people have
  261. written.  Reading articles.  Unfortunately, people are quite bad at
  262. writing, so there are tons of functions and variables to make reading
  263. these articles easier.
  264.  
  265. * Menu:
  266.  
  267. * Article Highlighting::    You want to make the article look like fruit salad.
  268. * Article Fontisizing::     Making emphasized text look niced.
  269. * Article Hiding::          You also want to make certain info go away.
  270. * Article Washing::         Lots of way-neat functions to make life better.
  271. * Article Buttons::         Click on URLs, Message-IDs, addresses and the like.
  272. * Article Date::            Grumble, UT!
  273. * Article Signature::       What is a signature?
  274.  
  275. 
  276. File: gnus.info,  Node: Article Highlighting,  Next: Article Fontisizing,  Up: Article Treatment
  277.  
  278. Article Highlighting
  279. --------------------
  280.  
  281.    Not only do you want your article buffer to look like fruit salad,
  282. but you want it to look like technicolor fruit salad.
  283.  
  284. `W H a'
  285.      Highlight the current article (`gnus-article-highlight').
  286.  
  287. `W H h'
  288.      Highlight the headers (`gnus-article-highlight-headers').  The
  289.      highlighting will be done according to the `gnus-header-face-alist'
  290.      variable, which is a list where each element has the form (REGEXP
  291.      NAME CONTENT).  REGEXP is a regular expression for matching the
  292.      header, NAME is the face used for highlighting the header name and
  293.      CONTENT is the face for highlighting the header value.  The first
  294.      match made will be used.  Note that REGEXP shouldn't have `^'
  295.      prepended--Gnus will add one.
  296.  
  297. `W H c'
  298.      Highlight cited text (`gnus-article-highlight-citation').
  299.  
  300.      Some variables to customize the citation highlights:
  301.  
  302.     `gnus-cite-parse-max-size'
  303.           If the article size if bigger than this variable (which is
  304.           25000 by default), no citation highlighting will be performed.
  305.  
  306.     `gnus-cite-prefix-regexp'
  307.           Regexp matching the longest possible citation prefix on a
  308.           line.
  309.  
  310.     `gnus-cite-max-prefix'
  311.           Maximum possible length for a citation prefix (default 20).
  312.  
  313.     `gnus-cite-face-list'
  314.           List of faces used for highlighting citations.  When there
  315.           are citations from multiple articles in the same message,
  316.           Gnus will try to give each citation from each article its own
  317.           face.  This should make it easier to see who wrote what.
  318.  
  319.     `gnus-supercite-regexp'
  320.           Regexp matching normal Supercite attribution lines.
  321.  
  322.     `gnus-supercite-secondary-regexp'
  323.           Regexp matching mangled Supercite attribution lines.
  324.  
  325.     `gnus-cite-minimum-match-count'
  326.           Minimum number of identical prefixes we have to see before we
  327.           believe that it's a citation.
  328.  
  329.     `gnus-cite-attribution-prefix'
  330.           Regexp matching the beginning of an attribution line.
  331.  
  332.     `gnus-cite-attribution-suffix'
  333.           Regexp matching the end of an attribution line.
  334.  
  335.     `gnus-cite-attribution-face'
  336.           Face used for attribution lines.  It is merged with the face
  337.           for the cited text belonging to the attribution.
  338.  
  339. `W H s'
  340.      Highlight the signature (`gnus-article-highlight-signature').
  341.      Everything after `gnus-signature-separator' (*note Article
  342.      Signature::.) in an article will be considered a signature and
  343.      will be highlighted with `gnus-signature-face', which is `italic'
  344.      by default.
  345.  
  346. 
  347. File: gnus.info,  Node: Article Fontisizing,  Next: Article Hiding,  Prev: Article Highlighting,  Up: Article Treatment
  348.  
  349. Article Fontisizing
  350. -------------------
  351.  
  352.    People commonly add emphasis to words in news articles by writing
  353. things like `_this_' or `*this*'.  Gnus can make this look nicer by
  354. running the article through the `W e' (`gnus-article-emphasize')
  355. command.
  356.  
  357.    How the emphasis is computed is controlled by the
  358. `gnus-article-emphasis' variable.  This is an alist where the first
  359. element is a regular expression to be matched.  The second is a number
  360. that says what regular expression grouping is used to find the entire
  361. emphasized word.  The third is a number that says what regexp grouping
  362. should be displayed and highlighted.  (The text between these two
  363. groupings will be hidden.)  The fourth is the face used for
  364. highlighting.
  365.  
  366.      (setq gnus-article-emphasis
  367.            '(("_\\(\\w+\\)_" 0 1 gnus-emphasis-underline)
  368.              ("\\*\\(\\w+\\)\\*" 0 1 gnus-emphasis-bold)))
  369.  
  370.    By default, there are seven rules, and they use the following faces:
  371. `gnus-emphasis-bold', `gnus-emphasis-italic',
  372. `gnus-emphasis-underline', `gnus-emphasis-bold-italic',
  373. `gnus-emphasis-underline-italic', `gnus-emphasis-underline-bold', and
  374. `gnus-emphasis-underline-bold-italic'.
  375.  
  376.    If you want to change these faces, you can either use `M-x
  377. customize', or you can use `copy-face'.  For instance, if you want to
  378. make `gnus-emphasis-italic' use a red face instead, you could say
  379. something like:
  380.  
  381.      (copy-face 'red 'gnus-emphasis-italic)
  382.  
  383. 
  384. File: gnus.info,  Node: Article Hiding,  Next: Article Washing,  Prev: Article Fontisizing,  Up: Article Treatment
  385.  
  386. Article Hiding
  387. --------------
  388.  
  389.    Or rather, hiding certain things in each article.  There usually is
  390. much too much cruft in most articles.
  391.  
  392. `W W a'
  393.      Do maximum hiding on the summary buffer (`gnus-article-hide').
  394.  
  395. `W W h'
  396.      Hide headers (`gnus-article-hide-headers').  *Note Hiding
  397.      Headers::.
  398.  
  399. `W W b'
  400.      Hide headers that aren't particularly interesting
  401.      (`gnus-article-hide-boring-headers').  *Note Hiding Headers::.
  402.  
  403. `W W s'
  404.      Hide signature (`gnus-article-hide-signature').  *Note Article
  405.      Signature::.
  406.  
  407. `W W p'
  408.      Hide PGP signatures (`gnus-article-hide-pgp').  The
  409.      `gnus-article-hide-pgp-hook' hook will be run after a PGP
  410.      signature has been hidden.
  411.  
  412. `W W P'
  413.      Hide PEM (privacy enhanced messages) cruft
  414.      (`gnus-article-hide-pem').
  415.  
  416. `W W c'
  417.      Hide citation (`gnus-article-hide-citation').  Some variables for
  418.      customizing the hiding:
  419.  
  420.     `gnus-cite-hide-percentage'
  421.           If the cited text is of a bigger percentage than this
  422.           variable (default 50), hide the cited text.
  423.  
  424.     `gnus-cite-hide-absolute'
  425.           The cited text must have at least this length (default 10)
  426.           before it is hidden.
  427.  
  428.     `gnus-cited-text-button-line-format'
  429.           Gnus adds buttons to show where the cited text has been
  430.           hidden, and to allow toggle hiding the text.  The format of
  431.           the variable is specified by this format-like variable (*note
  432.           Formatting Variables::.).  These specs are legal:
  433.  
  434.          `b'
  435.                Start point of the hidden text.
  436.  
  437.          `e'
  438.                End point of the hidden text.
  439.  
  440.          `l'
  441.                Length of the hidden text.
  442.  
  443.     `gnus-cited-lines-visible'
  444.           The number of lines at the beginning of the cited text to
  445.           leave shown.
  446.  
  447. `W W C'
  448.      Hide cited text in articles that aren't roots
  449.      (`gnus-article-hide-citation-in-followups').  This isn't very
  450.      useful as an interactive command, but might be a handy function to
  451.      stick in `gnus-article-display-hook' (*note Customizing
  452.      Articles::.).
  453.  
  454.    All these "hiding" commands are toggles, but if you give a negative
  455. prefix to these commands, they will show what they have previously
  456. hidden.  If you give a positive prefix, they will always hide.
  457.  
  458.    Also *note Article Highlighting::. for further variables for
  459. citation customization.
  460.  
  461. 
  462. File: gnus.info,  Node: Article Washing,  Next: Article Buttons,  Prev: Article Hiding,  Up: Article Treatment
  463.  
  464. Article Washing
  465. ---------------
  466.  
  467.    We call this "article washing" for a really good reason.  Namely, the
  468. `A' key was taken, so we had to use the `W' key instead.
  469.  
  470.    "Washing" is defined by us as "changing something from something to
  471. something else", but normally results in something looking better.
  472. Cleaner, perhaps.
  473.  
  474. `W l'
  475.      Remove page breaks from the current article
  476.      (`gnus-summary-stop-page-breaking').
  477.  
  478. `W r'
  479.      Do a Caesar rotate (rot13) on the article buffer
  480.      (`gnus-summary-caesar-message').
  481.  
  482. `W t'
  483.      Toggle whether to display all headers in the article buffer
  484.      (`gnus-summary-toggle-header').
  485.  
  486. `W v'
  487.      Toggle whether to display all headers in the article buffer
  488.      permanently (`gnus-summary-verbose-header').
  489.  
  490. `W m'
  491.      Toggle whether to run the article through MIME before displaying
  492.      (`gnus-summary-toggle-mime').
  493.  
  494. `W o'
  495.      Treat overstrike (`gnus-article-treat-overstrike').
  496.  
  497. `W w'
  498.      Do word wrap (`gnus-article-fill-cited-article').  If you use this
  499.      function in `gnus-article-display-hook', it should be run fairly
  500.      late and certainly after any highlighting.
  501.  
  502.      You can give the command a numerical prefix to specify the width
  503.      to use when filling.
  504.  
  505. `W c'
  506.      Remove CR (`gnus-article-remove-cr').
  507.  
  508. `W q'
  509.      Treat quoted-printable (`gnus-article-de-quoted-unreadable').
  510.  
  511. `W f'
  512.      Look for and display any X-Face headers
  513.      (`gnus-article-display-x-face').  The command executed by this
  514.      function is given by the `gnus-article-x-face-command' variable.
  515.      If this variable is a string, this string will be executed in a
  516.      sub-shell.  If it is a function, this function will be called with
  517.      the face as the argument.  If the `gnus-article-x-face-too-ugly'
  518.      (which is a regexp) matches the `From' header, the face will not
  519.      be shown.  The default action under Emacs is to fork off an `xv'
  520.      to view the face; under XEmacs the default action is to display
  521.      the face before the `From' header.  (It's nicer if XEmacs has been
  522.      compiled with X-Face support--that will make display somewhat
  523.      faster.  If there's no native X-Face support, Gnus will try to
  524.      convert the `X-Face' header using external programs from the
  525.      `pbmplus' package and friends.)  If you want to have this function
  526.      in the display hook, it should probably come last.
  527.  
  528. `W b'
  529.      Add clickable buttons to the article (`gnus-article-add-buttons').
  530.  
  531. `W B'
  532.      Add clickable buttons to the article headers
  533.      (`gnus-article-add-buttons-to-head').
  534.  
  535. `W E l'
  536.      Remove all blank lines from the beginning of the article
  537.      (`gnus-article-strip-leading-blank-lines').
  538.  
  539. `W E m'
  540.      Replace all blank lines with empty lines and then all multiple
  541.      empty lines with a single empty line.
  542.      (`gnus-article-strip-multiple-blank-lines').
  543.  
  544. `W E t'
  545.      Remove all blank lines at the end of the article
  546.      (`gnus-article-remove-trailing-blank-lines').
  547.  
  548. `W E a'
  549.      Do all the three commands above (`gnus-article-strip-blank-lines').
  550.  
  551. `W E s'
  552.      Remove all white space from the beginning of all lines of the
  553.      article body (`gnus-article-strip-leading-space').
  554.  
  555. 
  556. File: gnus.info,  Node: Article Buttons,  Next: Article Date,  Prev: Article Washing,  Up: Article Treatment
  557.  
  558. Article Buttons
  559. ---------------
  560.  
  561.    People often include references to other stuff in articles, and it
  562. would be nice if Gnus could just fetch whatever it is that people talk
  563. about with the minimum of fuzz.
  564.  
  565.    Gnus adds "buttons" to certain standard references by default:
  566. Well-formed URLs, mail addresses and Message-IDs.  This is controlled by
  567. two variables, one that handles article bodies and one that handles
  568. article heads:
  569.  
  570. `gnus-button-alist'
  571.      This is an alist where each entry has this form:
  572.  
  573.           (REGEXP BUTTON-PAR USE-P FUNCTION DATA-PAR)
  574.  
  575.     REGEXP
  576.           All text that match this regular expression will be
  577.           considered an external reference.  Here's a typical regexp
  578.           that matches embedded URLs: `<URL:\\([^\n\r>]*\\)>'.
  579.  
  580.     BUTTON-PAR
  581.           Gnus has to know which parts of the matches is to be
  582.           highlighted.  This is a number that says what sub-expression
  583.           of the regexp is to be highlighted.  If you want it all
  584.           highlighted, you use 0 here.
  585.  
  586.     USE-P
  587.           This form will be `eval'ed, and if the result is non-`nil',
  588.           this is considered a match.  This is useful if you want extra
  589.           sifting to avoid false matches.
  590.  
  591.     FUNCTION
  592.           This function will be called when you click on this button.
  593.  
  594.     DATA-PAR
  595.           As with BUTTON-PAR, this is a sub-expression number, but this
  596.           one says which part of the match is to be sent as data to
  597.           FUNCTION.
  598.  
  599.      So the full entry for buttonizing URLs is then
  600.  
  601.           ("<URL:\\([^\n\r>]*\\)>" 0 t gnus-button-url 1)
  602.  
  603. `gnus-header-button-alist'
  604.      This is just like the other alist, except that it is applied to the
  605.      article head only, and that each entry has an additional element
  606.      that is used to say what headers to apply the buttonize coding to:
  607.  
  608.           (HEADER REGEXP BUTTON-PAR USE-P FUNCTION DATA-PAR)
  609.  
  610.      HEADER is a regular expression.
  611.  
  612. `gnus-button-url-regexp'
  613.      A regular expression that matches embedded URLs.  It is used in the
  614.      default values of the variables above.
  615.  
  616. `gnus-article-button-face'
  617.      Face used on buttons.
  618.  
  619. `gnus-article-mouse-face'
  620.      Face used when the mouse cursor is over a button.
  621.  
  622. 
  623. File: gnus.info,  Node: Article Date,  Next: Article Signature,  Prev: Article Buttons,  Up: Article Treatment
  624.  
  625. Article Date
  626. ------------
  627.  
  628.    The date is most likely generated in some obscure timezone you've
  629. never heard of, so it's quite nice to be able to find out what the time
  630. was when the article was sent.
  631.  
  632. `W T u'
  633.      Display the date in UT (aka. GMT, aka ZULU)
  634.      (`gnus-article-date-ut').
  635.  
  636. `W T l'
  637.      Display the date in the local timezone (`gnus-article-date-local').
  638.  
  639. `W T s'
  640.      Display the date using a user-defined format
  641.      (`gnus-article-date-user').  The format is specified by the
  642.      `gnus-article-time-format' variable, and is a string that's passed
  643.      to `format-time-string'.  See the documentation of that variable
  644.      for a list of possible format specs.
  645.  
  646. `W T e'
  647.      Say how much time has elapsed between the article was posted and
  648.      now (`gnus-article-date-lapsed').
  649.  
  650. `W T o'
  651.      Display the original date (`gnus-article-date-original').  This can
  652.      be useful if you normally use some other conversion function and
  653.      are worried that it might be doing something totally wrong.  Say,
  654.      claiming that the article was posted in 1854.  Although something
  655.      like that is *totally* impossible.  Don't you trust me? *titter*
  656.  
  657. 
  658. File: gnus.info,  Node: Article Signature,  Prev: Article Date,  Up: Article Treatment
  659.  
  660. Article Signature
  661. -----------------
  662.  
  663.    Each article is divided into two parts--the head and the body.  The
  664. body can be divided into a signature part and a text part.  The variable
  665. that says what is to be considered a signature is
  666. `gnus-signature-separator'.  This is normally the standard `^-- $' as
  667. mandated by son-of-RFC 1036.  However, many people use non-standard
  668. signature separators, so this variable can also be a list of regular
  669. expressions to be tested, one by one.  (Searches are done from the end
  670. of the body towards the beginning.)  One likely value is:
  671.  
  672.      (setq gnus-signature-separator
  673.            '("^-- $"         ; The standard
  674.              "^-- *$"        ; A common mangling
  675.              "^-------*$"    ; Many people just use a looong
  676.                              ; line of dashes.  Shame!
  677.              "^ *--------*$" ; Double-shame!
  678.              "^________*$"   ; Underscores are also popular
  679.              "^========*$")) ; Pervert!
  680.  
  681.    The more permissive you are, the more likely it is that you'll get
  682. false positives.
  683.  
  684.    `gnus-signature-limit' provides a limit to what is considered a
  685. signature.
  686.  
  687.   1. If it is an integer, no signature may be longer (in characters)
  688.      than that integer.
  689.  
  690.   2. If it is a floating point number, no signature may be longer (in
  691.      lines) than that number.
  692.  
  693.   3. If it is a function, the function will be called without any
  694.      parameters, and if it returns `nil', there is no signature in the
  695.      buffer.
  696.  
  697.   4. If it is a string, it will be used as a regexp.  If it matches,
  698.      the text in question is not a signature.
  699.  
  700.    This variable can also be a list where the elements may be of the
  701. types listed above.
  702.  
  703. 
  704. File: gnus.info,  Node: Article Commands,  Next: Summary Sorting,  Prev: Article Treatment,  Up: The Summary Buffer
  705.  
  706. Article Commands
  707. ================
  708.  
  709. `A P'
  710.      Generate and print a PostScript image of the article buffer
  711.      (`gnus-summary-print-article').  `gnus-ps-print-hook' will be run
  712.      just before printing the buffer.
  713.  
  714. 
  715. File: gnus.info,  Node: Summary Sorting,  Next: Finding the Parent,  Prev: Article Commands,  Up: The Summary Buffer
  716.  
  717. Summary Sorting
  718. ===============
  719.  
  720.    You can have the summary buffer sorted in various ways, even though I
  721. can't really see why you'd want that.
  722.  
  723. `C-c C-s C-n'
  724.      Sort by article number (`gnus-summary-sort-by-number').
  725.  
  726. `C-c C-s C-a'
  727.      Sort by author (`gnus-summary-sort-by-author').
  728.  
  729. `C-c C-s C-s'
  730.      Sort by subject (`gnus-summary-sort-by-subject').
  731.  
  732. `C-c C-s C-d'
  733.      Sort by date (`gnus-summary-sort-by-date').
  734.  
  735. `C-c C-s C-l'
  736.      Sort by lines (`gnus-summary-sort-by-lines').
  737.  
  738. `C-c C-s C-i'
  739.      Sort by score (`gnus-summary-sort-by-score').
  740.  
  741.    These functions will work both when you use threading and when you
  742. don't use threading.  In the latter case, all summary lines will be
  743. sorted, line by line.  In the former case, sorting will be done on a
  744. root-by-root basis, which might not be what you were looking for.  To
  745. toggle whether to use threading, type `T T' (*note Thread Commands::.).
  746.  
  747. 
  748. File: gnus.info,  Node: Finding the Parent,  Next: Alternative Approaches,  Prev: Summary Sorting,  Up: The Summary Buffer
  749.  
  750. Finding the Parent
  751. ==================
  752.  
  753.    If you'd like to read the parent of the current article, and it is
  754. not displayed in the summary buffer, you might still be able to.  That
  755. is, if the current group is fetched by NNTP, the parent hasn't expired
  756. and the `References' in the current article are not mangled, you can
  757. just press `^' or `A r' (`gnus-summary-refer-parent-article').  If
  758. everything goes well, you'll get the parent.  If the parent is already
  759. displayed in the summary buffer, point will just move to this article.
  760.  
  761.    If given a positive numerical prefix, fetch that many articles back
  762. into the ancestry.  If given a negative numerical prefix, fetch just
  763. that ancestor.  So if you say `3 ^', Gnus will fetch the parent, the
  764. grandparent and the grandgrandparent of the current article.  If you say
  765. `-3 ^', Gnus will only fetch the grandgrandparent of the current
  766. article.
  767.  
  768.    You can have Gnus fetch all articles mentioned in the `References'
  769. header of the article by pushing `A R'
  770. (`gnus-summary-refer-references').
  771.  
  772.    You can also ask the NNTP server for an arbitrary article, no matter
  773. what group it belongs to.  `M-^' (`gnus-summary-refer-article') will
  774. ask you for a `Message-ID', which is one of those long, hard-to-read
  775. thingies that look something like `<38o6up$6f2@hymir.ifi.uio.no>'.  You
  776. have to get it all exactly right.  No fuzzy searches, I'm afraid.
  777.  
  778.    The current select method will be used when fetching by `Message-ID'
  779. from non-news select method, but you can override this by giving this
  780. command a prefix.
  781.  
  782.    If the group you are reading is located on a backend that does not
  783. support fetching by `Message-ID' very well (like `nnspool'), you can
  784. set `gnus-refer-article-method' to an NNTP method.  It would, perhaps,
  785. be best if the NNTP server you consult is the one updating the spool
  786. you are reading from, but that's not really necessary.
  787.  
  788.    Most of the mail backends support fetching by `Message-ID', but do
  789. not do a particularly excellent job at it.  That is, `nnmbox' and
  790. `nnbabyl' are able to locate articles from any groups, while `nnml' and
  791. `nnfolder' are only able to locate articles that have been posted to
  792. the current group.  (Anything else would be too time consuming.)
  793. `nnmh' does not support this at all.
  794.  
  795. 
  796. File: gnus.info,  Node: Alternative Approaches,  Next: Tree Display,  Prev: Finding the Parent,  Up: The Summary Buffer
  797.  
  798. Alternative Approaches
  799. ======================
  800.  
  801.    Different people like to read news using different methods.  This
  802. being Gnus, we offer a small selection of minor modes for the summary
  803. buffers.
  804.  
  805. * Menu:
  806.  
  807. * Pick and Read::               First mark articles and then read them.
  808. * Binary Groups::               Auto-decode all articles.
  809.  
  810. 
  811. File: gnus.info,  Node: Pick and Read,  Next: Binary Groups,  Up: Alternative Approaches
  812.  
  813. Pick and Read
  814. -------------
  815.  
  816.    Some newsreaders (like `nn' and, uhm, `Netnews' on VM/CMS) use a
  817. two-phased reading interface.  The user first marks in a summary buffer
  818. the articles she wants to read.  Then she starts reading the articles
  819. with just an article buffer displayed.
  820.  
  821.    Gnus provides a summary buffer minor mode that allows
  822. this--`gnus-pick-mode'.  This basically means that a few process mark
  823. commands become one-keystroke commands to allow easy marking, and it
  824. provides one additional command for switching to the summary buffer.
  825.  
  826.    Here are the available keystrokes when using pick mode:
  827.  
  828. `.'
  829.      Pick the article on the current line
  830.      (`gnus-summary-mark-as-processable').  If given a numerical prefix,
  831.      go to that article and pick it.  (The line number is normally
  832.      displayed at the beginning of the summary pick lines.)
  833.  
  834. `SPACE'
  835.      Scroll the summary buffer up one page (`gnus-pick-next-page').  If
  836.      at the end of the buffer, start reading the picked articles.
  837.  
  838. `u'
  839.      Unpick the article (`gnus-summary-unmark-as-processable').
  840.  
  841. `U'
  842.      Unpick all articles (`gnus-summary-unmark-all-processable').
  843.  
  844. `t'
  845.      Pick the thread (`gnus-uu-mark-thread').
  846.  
  847. `T'
  848.      Unpick the thread (`gnus-uu-unmark-thread').
  849.  
  850. `r'
  851.      Pick the region (`gnus-uu-mark-region').
  852.  
  853. `R'
  854.      Unpick the region (`gnus-uu-unmark-region').
  855.  
  856. `e'
  857.      Pick articles that match a regexp (`gnus-uu-mark-by-regexp').
  858.  
  859. `E'
  860.      Unpick articles that match a regexp (`gnus-uu-unmark-by-regexp').
  861.  
  862. `b'
  863.      Pick the buffer (`gnus-uu-mark-buffer').
  864.  
  865. `B'
  866.      Unpick the buffer (`gnus-uu-unmark-buffer').
  867.  
  868. `RET'
  869.      Start reading the picked articles (`gnus-pick-start-reading').  If
  870.      given a prefix, mark all unpicked articles as read first.  If
  871.      `gnus-pick-display-summary' is non-`nil', the summary buffer will
  872.      still be visible when you are reading.
  873.  
  874.    If this sounds like a good idea to you, you could say:
  875.  
  876.      (add-hook 'gnus-summary-mode-hook 'gnus-pick-mode)
  877.  
  878.    `gnus-pick-mode-hook' is run in pick minor mode buffers.
  879.  
  880.    If `gnus-mark-unpicked-articles-as-read' is non-`nil', mark all
  881. unpicked articles as read.  The default is `nil'.
  882.  
  883.    The summary line format in pick mode is slightly different from the
  884. standard format.  At the beginning of each line the line number is
  885. displayed.  The pick mode line format is controlled by the
  886. `gnus-summary-pick-line-format' variable (*note Formatting
  887. Variables::.).  It accepts the same format specs that
  888. `gnus-summary-line-format' does (*note Summary Buffer Lines::.).
  889.  
  890. 
  891. File: gnus.info,  Node: Binary Groups,  Prev: Pick and Read,  Up: Alternative Approaches
  892.  
  893. Binary Groups
  894. -------------
  895.  
  896.    If you spend much time in binary groups, you may grow tired of
  897. hitting `X u', `n', `RET' all the time.  `M-x gnus-binary-mode' is a
  898. minor mode for summary buffers that makes all ordinary Gnus article
  899. selection functions uudecode series of articles and display the result
  900. instead of just displaying the articles the normal way.
  901.  
  902.    The only way, in fact, to see the actual articles is the `g'
  903. command, when you have turned on this mode (`gnus-binary-show-article').
  904.  
  905.    `gnus-binary-mode-hook' is called in binary minor mode buffers.
  906.  
  907. 
  908. File: gnus.info,  Node: Tree Display,  Next: Mail Group Commands,  Prev: Alternative Approaches,  Up: The Summary Buffer
  909.  
  910. Tree Display
  911. ============
  912.  
  913.    If you don't like the normal Gnus summary display, you might try
  914. setting `gnus-use-trees' to `t'.  This will create (by default) an
  915. additional "tree buffer".  You can execute all summary mode commands in
  916. the tree buffer.
  917.  
  918.    There are a few variables to customize the tree display, of course:
  919.  
  920. `gnus-tree-mode-hook'
  921.      A hook called in all tree mode buffers.
  922.  
  923. `gnus-tree-mode-line-format'
  924.      A format string for the mode bar in the tree mode buffers.  The
  925.      default is `Gnus: %%b [%A] %Z'.  For a list of legal specs, *note
  926.      Summary Buffer Mode Line::..
  927.  
  928. `gnus-selected-tree-face'
  929.      Face used for highlighting the selected article in the tree
  930.      buffer.  The default is `modeline'.
  931.  
  932. `gnus-tree-line-format'
  933.      A format string for the tree nodes.  The name is a bit of a
  934.      misnomer, though--it doesn't define a line, but just the node.
  935.      The default value is `%(%[%3,3n%]%)', which displays the first
  936.      three characters of the name of the poster.  It is vital that all
  937.      nodes are of the same length, so you *must* use `%4,4n'-like
  938.      specifiers.
  939.  
  940.      Legal specs are:
  941.  
  942.     `n'
  943.           The name of the poster.
  944.  
  945.     `f'
  946.           The `From' header.
  947.  
  948.     `N'
  949.           The number of the article.
  950.  
  951.     `['
  952.           The opening bracket.
  953.  
  954.     `]'
  955.           The closing bracket.
  956.  
  957.     `s'
  958.           The subject.
  959.  
  960.      *Note Formatting Variables::.
  961.  
  962.      Variables related to the display are:
  963.  
  964.     `gnus-tree-brackets'
  965.           This is used for differentiating between "real" articles and
  966.           "sparse" articles.  The format is ((REAL-OPEN . REAL-CLOSE)
  967.           (SPARSE-OPEN . SPARSE-CLOSE) (DUMMY-OPEN . DUMMY-CLOSE)), and
  968.           the default is `((?[ . ?]) (?( . ?)) (?{ . ?}))'.
  969.  
  970.     `gnus-tree-parent-child-edges'
  971.           This is a list that contains the characters used for
  972.           connecting parent nodes to their children.  The default is
  973.           `(?- ?\\ ?|)'.
  974.  
  975. `gnus-tree-minimize-window'
  976.      If this variable is non-`nil', Gnus will try to keep the tree
  977.      buffer as small as possible to allow more room for the other Gnus
  978.      windows.  If this variable is a number, the tree buffer will never
  979.      be higher than that number.  The default is `t'.  Note that if you
  980.      have several windows displayed side-by-side in a frame and the tree
  981.      buffer is one of these, minimizing the tree window will also
  982.      resize all other windows displayed next to it.
  983.  
  984. `gnus-generate-tree-function'
  985.      The function that actually generates the thread tree.  Two
  986.      predefined functions are available:
  987.      `gnus-generate-horizontal-tree' and `gnus-generate-vertical-tree'
  988.      (which is the default).
  989.  
  990.    Here's an example from a horizontal tree buffer:
  991.  
  992.      {***}-(***)-[odd]-[Gun]
  993.           |      \[Jan]
  994.           |      \[odd]-[Eri]
  995.           |      \(***)-[Eri]
  996.           |            \[odd]-[Paa]
  997.           \[Bjo]
  998.           \[Gun]
  999.           \[Gun]-[Jor]
  1000.  
  1001.    Here's the same thread displayed in a vertical tree buffer:
  1002.  
  1003.      {***}
  1004.        |--------------------------\-----\-----\
  1005.      (***)                         [Bjo] [Gun] [Gun]
  1006.        |--\-----\-----\                          |
  1007.      [odd] [Jan] [odd] (***)                   [Jor]
  1008.        |           |     |--\
  1009.      [Gun]       [Eri] [Eri] [odd]
  1010.                                |
  1011.                              [Paa]
  1012.  
  1013.    If you're using horizontal trees, it might be nice to display the
  1014. trees side-by-side with the summary buffer.  You could add something
  1015. like the following to your `.gnus.el' file:
  1016.  
  1017.      (setq gnus-use-trees t
  1018.            gnus-generate-tree-function 'gnus-generate-horizontal-tree
  1019.            gnus-tree-minimize-window nil)
  1020.      (gnus-add-configuration
  1021.       '(article
  1022.         (vertical 1.0
  1023.                   (horizontal 0.25
  1024.                               (summary 0.75 point)
  1025.                               (tree 1.0))
  1026.                   (article 1.0))))
  1027.  
  1028.    *Note Windows Configuration::.
  1029.  
  1030. 
  1031. File: gnus.info,  Node: Mail Group Commands,  Next: Various Summary Stuff,  Prev: Tree Display,  Up: The Summary Buffer
  1032.  
  1033. Mail Group Commands
  1034. ===================
  1035.  
  1036.    Some commands only make sense in mail groups.  If these commands are
  1037. illegal in the current group, they will raise hell and let you know.
  1038.  
  1039.    All these commands (except the expiry and edit commands) use the
  1040. process/prefix convention (*note Process/Prefix::.).
  1041.  
  1042. `B e'
  1043.      Expire all expirable articles in the group
  1044.      (`gnus-summary-expire-articles').
  1045.  
  1046. `B M-C-e'
  1047.      Delete all the expirable articles in the group
  1048.      (`gnus-summary-expire-articles-now').  This means that *all*
  1049.      articles eligible for expiry in the current group will disappear
  1050.      forever into that big `/dev/null' in the sky.
  1051.  
  1052. `B DEL'
  1053.      Delete the mail article.  This is "delete" as in "delete it from
  1054.      your disk forever and ever, never to return again." Use with
  1055.      caution.  (`gnus-summary-delete-article').
  1056.  
  1057. `B m'
  1058.      Move the article from one mail group to another
  1059.      (`gnus-summary-move-article').
  1060.  
  1061. `B c'
  1062.      Copy the article from one group (mail group or not) to a mail group
  1063.      (`gnus-summary-copy-article').
  1064.  
  1065. `B C'
  1066.      Crosspost the current article to some other group
  1067.      (`gnus-summary-crosspost-article').  This will create a new copy of
  1068.      the article in the other group, and the Xref headers of the
  1069.      article will be properly updated.
  1070.  
  1071. `B i'
  1072.      Import an arbitrary file into the current mail newsgroup
  1073.      (`gnus-summary-import-article').  You will be prompted for a file
  1074.      name, a `From' header and a `Subject' header.
  1075.  
  1076. `B r'
  1077.      Respool the mail article (`gnus-summary-move-article').
  1078.      `gnus-summary-respool-default-method' will be used as the default
  1079.      select method when respooling.  This variable is `nil' by default,
  1080.      which means that the current group select method will be used
  1081.      instead.
  1082.  
  1083. `B w'
  1084. `e'
  1085.      Edit the current article (`gnus-summary-edit-article').  To finish
  1086.      editing and make the changes permanent, type `C-c C-c'
  1087.      (`gnus-summary-edit-article-done').
  1088.  
  1089. `B q'
  1090.      If you want to re-spool an article, you might be curious as to
  1091.      what group the article will end up in before you do the
  1092.      re-spooling.  This command will tell you
  1093.      (`gnus-summary-respool-query').
  1094.  
  1095. `B p'
  1096.      Some people have a tendency to send you "courtesy" copies when they
  1097.      follow up to articles you have posted.  These usually have a
  1098.      `Newsgroups' header in them, but not always.  This command
  1099.      (`gnus-summary-article-posted-p') will try to fetch the current
  1100.      article from your news server (or rather, from
  1101.      `gnus-refer-article-method' or `gnus-select-method') and will
  1102.      report back whether it found the article or not.  Even if it says
  1103.      that it didn't find the article, it may have been posted
  1104.      anyway--mail propagation is much faster than news propagation, and
  1105.      the news copy may just not have arrived yet.
  1106.  
  1107.    If you move (or copy) articles regularly, you might wish to have Gnus
  1108. suggest where to put the articles.  `gnus-move-split-methods' is a
  1109. variable that uses the same syntax as `gnus-split-methods' (*note
  1110. Saving Articles::.).  You may customize that variable to create
  1111. suggestions you find reasonable.
  1112.  
  1113.      (setq gnus-move-split-methods
  1114.            '(("^From:.*Lars Magne" "nnml:junk")
  1115.              ("^Subject:.*gnus" "nnfolder:important")
  1116.              (".*" "nnml:misc")))
  1117.  
  1118. 
  1119. File: gnus.info,  Node: Various Summary Stuff,  Next: Exiting the Summary Buffer,  Prev: Mail Group Commands,  Up: The Summary Buffer
  1120.  
  1121. Various Summary Stuff
  1122. =====================
  1123.  
  1124. * Menu:
  1125.  
  1126. * Summary Group Information::         Information oriented commands.
  1127. * Searching for Articles::            Multiple article commands.
  1128. * Summary Generation Commands::       (Re)generating the summary buffer.
  1129. * Really Various Summary Commands::   Those pesky non-conformant commands.
  1130.  
  1131. `gnus-summary-mode-hook'
  1132.      This hook is called when creating a summary mode buffer.
  1133.  
  1134. `gnus-summary-generate-hook'
  1135.      This is called as the last thing before doing the threading and the
  1136.      generation of the summary buffer.  It's quite convenient for
  1137.      customizing the threading variables based on what data the
  1138.      newsgroup has.  This hook is called from the summary buffer after
  1139.      most summary buffer variables have been set.
  1140.  
  1141. `gnus-summary-prepare-hook'
  1142.      It is called after the summary buffer has been generated.  You
  1143.      might use it to, for instance, highlight lines or modify the look
  1144.      of the buffer in some other ungodly manner.  I don't care.
  1145.  
  1146. `gnus-summary-ignore-duplicates'
  1147.      When Gnus discovers two articles that have the same `Message-ID',
  1148.      it has to do something drastic.  No articles are allowed to have
  1149.      the same `Message-ID', but this may happen when reading mail from
  1150.      some sources.  Gnus allows you to customize what happens with this
  1151.      variable.  If it is `nil' (which is the default), Gnus will rename
  1152.      the `Message-ID' (for display purposes only) and display the
  1153.      article as any other article.  If this variable is `t', it won't
  1154.      display the article--it'll be as if it never existed.
  1155.  
  1156. 
  1157. File: gnus.info,  Node: Summary Group Information,  Next: Searching for Articles,  Up: Various Summary Stuff
  1158.  
  1159. Summary Group Information
  1160. -------------------------
  1161.  
  1162. `H f'
  1163.      Try to fetch the FAQ (list of frequently asked questions) for the
  1164.      current group (`gnus-summary-fetch-faq').  Gnus will try to get the
  1165.      FAQ from `gnus-group-faq-directory', which is usually a directory
  1166.      on a remote machine.  This variable can also be a list of
  1167.      directories.  In that case, giving a prefix to this command will
  1168.      allow you to choose between the various sites.  `ange-ftp' or
  1169.      `efs' will probably be used for fetching the file.
  1170.  
  1171. `H d'
  1172.      Give a brief description of the current group
  1173.      (`gnus-summary-describe-group').  If given a prefix, force
  1174.      rereading the description from the server.
  1175.  
  1176. `H h'
  1177.      Give an extremely brief description of the most important summary
  1178.      keystrokes (`gnus-summary-describe-briefly').
  1179.  
  1180. `H i'
  1181.      Go to the Gnus info node (`gnus-info-find-node').
  1182.  
  1183. 
  1184. File: gnus.info,  Node: Searching for Articles,  Next: Summary Generation Commands,  Prev: Summary Group Information,  Up: Various Summary Stuff
  1185.  
  1186. Searching for Articles
  1187. ----------------------
  1188.  
  1189. `M-s'
  1190.      Search through all subsequent articles for a regexp
  1191.      (`gnus-summary-search-article-forward').
  1192.  
  1193. `M-r'
  1194.      Search through all previous articles for a regexp
  1195.      (`gnus-summary-search-article-backward').
  1196.  
  1197. `&'
  1198.      This command will prompt you for a header field, a regular
  1199.      expression to match on this field, and a command to be executed if
  1200.      the match is made (`gnus-summary-execute-command').  If given a
  1201.      prefix, search backward instead.
  1202.  
  1203. `M-&'
  1204.      Perform any operation on all articles that have been marked with
  1205.      the process mark (`gnus-summary-universal-argument').
  1206.  
  1207. 
  1208. File: gnus.info,  Node: Summary Generation Commands,  Next: Really Various Summary Commands,  Prev: Searching for Articles,  Up: Various Summary Stuff
  1209.  
  1210. Summary Generation Commands
  1211. ---------------------------
  1212.  
  1213. `Y g'
  1214.      Regenerate the current summary buffer (`gnus-summary-prepare').
  1215.  
  1216. `Y c'
  1217.      Pull all cached articles (for the current group) into the summary
  1218.      buffer (`gnus-summary-insert-cached-articles').
  1219.  
  1220. 
  1221. File: gnus.info,  Node: Really Various Summary Commands,  Prev: Summary Generation Commands,  Up: Various Summary Stuff
  1222.  
  1223. Really Various Summary Commands
  1224. -------------------------------
  1225.  
  1226. `C-d'
  1227.      If the current article is a collection of other articles (for
  1228.      instance, a digest), you might use this command to enter a group
  1229.      based on the that article (`gnus-summary-enter-digest-group').
  1230.      Gnus will try to guess what article type is currently displayed
  1231.      unless you give a prefix to this command, which forces a "digest"
  1232.      interpretation.  Basically, whenever you see a message that is a
  1233.      collection of other messages of some format, you `C-d' and read
  1234.      these messages in a more convenient fashion.
  1235.  
  1236. `M-C-d'
  1237.      This command is very similar to the one above, but lets you gather
  1238.      several documents into one biiig group
  1239.      (`gnus-summary-read-document').  It does this by opening several
  1240.      `nndoc' groups for each document, and then opening an `nnvirtual'
  1241.      group on top of these `nndoc' groups.  This command understands
  1242.      the process/prefix convention (*note Process/Prefix::.).
  1243.  
  1244. `C-t'
  1245.      Toggle truncation of summary lines
  1246.      (`gnus-summary-toggle-truncation').  This will probably confuse the
  1247.      line centering function in the summary buffer, so it's not a good
  1248.      idea to have truncation switched off while reading articles.
  1249.  
  1250. `='
  1251.      Expand the summary buffer window (`gnus-summary-expand-window').
  1252.      If given a prefix, force an `article' window configuration.
  1253.  
  1254. 
  1255. File: gnus.info,  Node: Exiting the Summary Buffer,  Next: Crosspost Handling,  Prev: Various Summary Stuff,  Up: The Summary Buffer
  1256.  
  1257. Exiting the Summary Buffer
  1258. ==========================
  1259.  
  1260.    Exiting from the summary buffer will normally update all info on the
  1261. group and return you to the group buffer.
  1262.  
  1263. `Z Z'
  1264. `q'
  1265.      Exit the current group and update all information on the group
  1266.      (`gnus-summary-exit'). `gnus-summary-prepare-exit-hook' is called
  1267.      before doing much of the exiting, which calls
  1268.      `gnus-summary-expire-articles' by default.
  1269.      `gnus-summary-exit-hook' is called after finishing the exit
  1270.      process.  `gnus-group-no-more-groups-hook' is run when returning to
  1271.      group mode having no more (unread) groups.
  1272.  
  1273. `Z E'
  1274. `Q'
  1275.      Exit the current group without updating any information on the
  1276.      group (`gnus-summary-exit-no-update').
  1277.  
  1278. `Z c'
  1279. `c'
  1280.      Mark all unticked articles in the group as read and then exit
  1281.      (`gnus-summary-catchup-and-exit').
  1282.  
  1283. `Z C'
  1284.      Mark all articles, even the ticked ones, as read and then exit
  1285.      (`gnus-summary-catchup-all-and-exit').
  1286.  
  1287. `Z n'
  1288.      Mark all articles as read and go to the next group
  1289.      (`gnus-summary-catchup-and-goto-next-group').
  1290.  
  1291. `Z R'
  1292.      Exit this group, and then enter it again
  1293.      (`gnus-summary-reselect-current-group').  If given a prefix, select
  1294.      all articles, both read and unread.
  1295.  
  1296. `Z G'
  1297. `M-g'
  1298.      Exit the group, check for new articles in the group, and select the
  1299.      group (`gnus-summary-rescan-group').  If given a prefix, select all
  1300.      articles, both read and unread.
  1301.  
  1302. `Z N'
  1303.      Exit the group and go to the next group
  1304.      (`gnus-summary-next-group').
  1305.  
  1306. `Z P'
  1307.      Exit the group and go to the previous group
  1308.      (`gnus-summary-prev-group').
  1309.  
  1310. `Z s'
  1311.      Save the current number of read/marked articles in the dribble
  1312.      buffer and then save the dribble buffer
  1313.      (`gnus-summary-save-newsrc').  If given a prefix, also save the
  1314.      `.newsrc' file(s).  Using this command will make exit without
  1315.      updating (the `Q' command) worthless.
  1316.  
  1317.    `gnus-exit-group-hook' is called when you exit the current group.
  1318.  
  1319.    If you're in the habit of exiting groups, and then changing your mind
  1320. about it, you might set `gnus-kill-summary-on-exit' to `nil'.  If you
  1321. do that, Gnus won't kill the summary buffer when you exit it.  (Quelle
  1322. surprise!)  Instead it will change the name of the buffer to something
  1323. like `*Dead Summary ... *' and install a minor mode called
  1324. `gnus-dead-summary-mode'.  Now, if you switch back to this buffer,
  1325. you'll find that all keys are mapped to a function called
  1326. `gnus-summary-wake-up-the-dead'.  So tapping any keys in a dead summary
  1327. buffer will result in a live, normal summary buffer.
  1328.  
  1329.    There will never be more than one dead summary buffer at any one
  1330. time.
  1331.  
  1332.    The data on the current group will be updated (which articles you
  1333. have read, which articles you have replied to, etc.) when you exit the
  1334. summary buffer.  If the `gnus-use-cross-reference' variable is `t'
  1335. (which is the default), articles that are cross-referenced to this
  1336. group and are marked as read, will also be marked as read in the other
  1337. subscribed groups they were cross-posted to.  If this variable is
  1338. neither `nil' nor `t', the article will be marked as read in both
  1339. subscribed and unsubscribed groups (*note Crosspost Handling::.).
  1340.  
  1341.